home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / disk / cf_102d.zip / CF.DOC < prev    next >
Text File  |  1996-11-04  |  12KB  |  306 lines
  1.  
  2.                          ┌───────────────────────────┐
  3.                            Change Fast version 1.02d
  4.  
  5.                                    Re-release
  6.  
  7.                             Programmed by D.Manders
  8.                              (C) DMSoft 1995-1996
  9.                          └───────────────────────────┘
  10.  
  11.  
  12.         1.......INTRODUCTION
  13.           1.1....Introduction
  14.           1.2....So what is CF ?
  15.           1.3....'Jumping' from one directory to another ?
  16.  
  17.         2.......USING CF
  18.           2.1....Working with CF
  19.           2.2....Directories with the same name
  20.           2.3....Some more info
  21.           2.4....Usage (overview)
  22.           2.5....Examples
  23.           2.6....Tips/Hints
  24.           2.7....Notes
  25.  
  26.         3.......GENERAL INFO
  27.           3.1....What's new in version 1.02d
  28.           3.2....History of CF
  29.           3.3....On CF
  30.           3.4....Copyright
  31.  
  32.  
  33.  
  34.  ┌──────────────────┐
  35. ─┤ 1 - INTRODUCTION ├───────────────────────────────────────────────────────────
  36.  └──────────────────┘
  37.  
  38. 1.1 - Introduction:
  39. ───────────────────
  40.  
  41. There are a lot of programs wich do quite the same as CF, so why CF ???
  42. CF is very small, quite fast, easy to use and last-but-not-least FREEWARE !
  43.  
  44.  
  45. 1.2 - So what IS CF ?
  46. ─────────────────────
  47.  
  48. You might know programs such as NCD and TO_QUICK. These programs alow you to
  49. 'jump' from one directory to another by calling the program with the directory
  50. you want to 'jump' to as parameter. To put it simple: CF is just another NCD
  51. 'clone' (but a good one).
  52.  
  53.  
  54. 1.3 - 'Jumping' from one directory to another ???
  55. ─────────────────────────────────────────────────
  56.  
  57. Ok, an example:
  58.  
  59. Let's say you're in the C:\DOS directory and you want to goto C:\GAMES\MYGAME\B.
  60. Normally you would type "CD \" - "CD GAMES" - "CD MYGAME" - "CD B". Yes, it's
  61. also possible to type "CD \GAMES\MYGAME\B" but either way it's quite a lot of
  62. typing. With CF you'll never have to type more than the directory you want to
  63. go to (in this case "CF B").
  64.  
  65.  
  66.  
  67.  ┌──────────────┐
  68. ─┤ 2 - USING CF ├───────────────────────────────────────────────────────────────
  69.  └──────────────┘
  70.  
  71. 2.1 - Working with CF:
  72. ──────────────────────
  73.  
  74. The usage of CF is quite simple, first you scan the current disk and then you
  75. can just run CF with the directory to go to as a parameter (e.g. "CF DOS"). You
  76. can also specify a drive in the directoryname ("CF C:DOS"), but the drive you're
  77. refering to must have it's own datafile in the root directory. Pathnames are NOT
  78. alowed (these won't work: "CF C:\GAMES\TETRIS", "CF DOS\UTILS" or "CF ..").
  79.  
  80. As said before, first of all you must scan the current disk, so CF can create a
  81. datafile wich is used as a lookup table with all directories on the current disk
  82. in it. CF uses this file to find the location of the directory you want to go
  83. to. This datafile is easily created by running CF with the option /S (=Scan).
  84.  
  85. With CF it is also very easy to 'jump' back to the previous directory wich you
  86. visited using CF. Just type: "CF /P". With this option you can also 'jump'
  87. between two directories (just keep typing "CF /P").
  88.  
  89. Every now and then you should update the datafile because new directories might
  90. have been created (you don't have to update the datafile if you only have
  91. removed directories). To update just scan the current disk again with "CF /S".
  92.  
  93. It's possible to combine the scanning of a disk with going to a directory, e.g.
  94. "CF /S DOS" will first scan the disk and than go to DOS.
  95.  
  96.  
  97. 2.2 - Directories with the same name:
  98. ─────────────────────────────────────
  99.  
  100. It's possible that you have more directories with the same name. Normally CF
  101. will go to the first matching directory in the directory tree. If you want to
  102. go to another directory in the tree with the specified name you can specify the
  103. number of the directory to go to as an extra parameter. e.g. you have 4
  104. directories with the name SOUND and you want to go to the second one, you type:
  105. "CF SOUND 2". You can specify any number from 1 to 255, higher or lower numbers
  106. are ignored and will make CF take the first directory.
  107.  
  108.  
  109. 2.3 - Some more Info:
  110. ─────────────────────
  111.  
  112. Wildcards are not (yet) supported because I didn't thought it would be very
  113. useful due to the number of times that a wildcard specification will match more
  114. than 1 directory, forcing you to still have to specify wich directory you really
  115. meant in the first place. The ownly possible advantage of wilcards I can think
  116. of is that you can specify 'difficult' directory names such as "SP#(PTZX" much
  117. faster. But even than a better alternative would be renaming the directoryname !
  118.  
  119. The datafile wich CF creates when scanning a drive will be stored in the root
  120. directory of the drive you're scanning. The name of this file is DIRFILE.DAT,
  121. and will normally be hidden. Why 'normally' you may ask... Well, the minute you
  122. start up CF, the file will be unhidden so CF can use it to read from it or write
  123. to it. After CF is done with reading/writing the file will be hidden again.
  124. However, it's possible that an error may occur while reading/writing this file
  125. and CF might not be able to hide it. So if you see an unhidden file called
  126. DIRFILE.DAT in your root directory, then you now know what it is and what it is
  127. doing there....
  128.  
  129.  
  130. 2.4 - Usage Overview:
  131. ─────────────────────
  132.  
  133. global usage: CF <option> <directory> <nr>
  134.  
  135. options:
  136.  /S  : Scan current disk
  137.  /P  : Goto previous directory
  138.  
  139.  
  140. You can run CF in these ways: - CF                  [this will give short help]
  141.                               - CF /S               [scan current disk]
  142.                               - CF <directory>      [goto specified directory]
  143.                               - CF /S <directory>   [combine scanning and goto]
  144.                               - CF <directory> <nr> [goto nr matching directory]
  145.                               - CF /P <directory>   [goto previous directory]
  146.  
  147. Options may be placed anywhere on the commandline ("CF DOS /S 1" is possible).
  148.  
  149. Whenever /P is on the commandline, everything else will be ignored ("CF /P" will
  150.  do the same as "CF TEST 2 /S /P").
  151.  
  152.  
  153. 2.5 - Examples:
  154. ───────────────
  155.  
  156. "CF /S"         - Scan the current disk.
  157. "CF EXAMPLE"    - Go to directory EXAMPLE.
  158. "CF /S DOS"     - Scan current disk and go to DOS afterwards.
  159. "CF SOUND 3"    - Goto the thirth directory matching the name SOUND.
  160. "CF /S SOUND 3" - Scan current disk and goto third directory matching SOUND.
  161. "CF SOUND" -> "CF GAMES" -> "CF /P" - Go back to directory SOUND.
  162.  
  163.  
  164. 2.6 - Tips/Hints:
  165. ─────────────────
  166.  
  167. In order to use CF from any directory, you must put CF in a directory wich is in
  168.  your DOS PATH. (e.g. C:\DOS).
  169.  
  170. CF will be faster if you put it in the first directory in your DOS path.
  171.  
  172. Run SMARTDRV, it will make CF a lot faster.
  173.  
  174.  
  175. 2.7 - Notes:
  176. ────────────
  177.  
  178.  Each disk has its own datafile (DIRFILE.DAT) after scanning. Deleting this file
  179.   will simply result in a "Datafile not found..." error and will do no harm.
  180.  
  181.  CF works on floppy drives but I don't recommend this due to the slow speed of
  182.   floppy drives. CF should actually work on any writeable media and won't work
  183.   on read-only media such as a write-protected diskette or a CD-ROM. CF has not
  184.   been tested on a network drive, so results can not be predicted...
  185.  
  186. You can abort a scan by pressing Ctrl-Break, but use this in 'emergency' cases
  187.  only, because when you do interrupt the scanning the datafile will be
  188.  incomplete, forcing you to rescan the disk. You'll also will have no DOS cursor
  189.  anymore (just type "MODE co80" to get it back).
  190.  
  191.  
  192.  
  193.  ┌──────────────────┐
  194. ─┤ 3 - GENERAL INFO ├───────────────────────────────────────────────────────────
  195.  └──────────────────┘
  196.  
  197. 3.1 - New in version 1.02d:
  198. ───────────────────────────
  199.  
  200. - Added "/P" option, wich will change back to the previous directory wich was
  201.   visited while using CF.
  202.  
  203. - Much better commandline parsing is done. Options can now be anywhere on the
  204.   commandline. More detailed errors are reported when an error was found while
  205.   parsing the commandline.
  206.  
  207. - CF is an EXE-file again.
  208.  
  209. - Some small stuff: Better (easier to understand) error messages.
  210.                     Much much better manual.
  211.  
  212. * RE-RELEASE: - Fixed some errors in the manual (no modifications to CF itself).
  213.               - Added buglist file (bugs.doc).
  214.               - Added registration form (register.doc).
  215.  
  216.  
  217. 3.2 - HISTORY of CF:
  218. ────────────────────
  219.  
  220. 06/23/1995      version 1.00ßⁿ  - First version.
  221.  
  222. 06/25/1995      version 1.00    - Implemented CFSCAN inside CF ("CF /S").
  223.                                 - Now shows usage of CF when running CF without
  224.                                   parameters.
  225.  
  226. 08/10/1995      version 1.01c   - Scanning and going to is much faster.
  227.                                 - DIRFILE.DAT is much smaller.
  228.                                 - Now fully DOS' CD compatible.
  229.                                 - Scanning and going to can now be combined.
  230.                                 - Fixed some small bugs.
  231.                                 - Exact directory choosing now possible.
  232.  
  233. 10/07/1995      version 1.02    - CF is a COM file instead of an EXE.
  234.                                 - Exact directory selecting can now be combined
  235.                                   with scanning.
  236.                                 - Now able to go to another drive.
  237.  
  238. 08/06/1996      version 1.02d   - CF is an EXE file again.
  239.  re-released 11/04/1996         - Added "CF /P" wich will take you back to the
  240.                                   previous directory visited with CF.
  241.                                 - Better commandline parsing. Options can now
  242.                                   be anywhere on the commandline.
  243.                                 - Better error messages.
  244.  
  245. (ⁿ - unreleased version)
  246.  
  247.  
  248. 3.3 - On CF:
  249. ────────────
  250.  
  251. Change Fast is programmed for 95% in Pascal, the rest (some small routines) is
  252. done in assembler and machinecode.
  253.  
  254. I've been working on CF 1.10 for about half a year but due to some technical
  255. difficulties (a lot of bugs in the source) I decided to release this optimized
  256. version of version 1.02. The commandline parsing routine was copied from v1.10
  257. (no bugs in there), and most of this manual was also copied from the CF 1.10ß
  258. manual.
  259.  
  260. I'm currently working on CF 1.30, it is a total re-written version with some
  261. new powerful options. Because CF 1.30 is far from finished and CF 1.02d works
  262. pretty fine I might decide to discontinue working on CF. If you really want a
  263. new version of CF then please let me know ! Knowing that people like your work
  264. surely gives a man the motivation to continue doing what he is doing !
  265.  
  266. Please fill out the Registration Form ! This will not only make you feel better,
  267. it will also give me an overview of the users of CF. Don't get me wrong here:
  268. Registering is on a voluntary basis only, you don't have to register if you
  269. don't want to. But since registering is free I really see no reason why you
  270. shouldn't register ! Registering can be done via e-mail only, registration form
  271. is included (REGISTER.DOC).
  272.  
  273.  
  274. 3.4 - Copyright:
  275. ────────────────
  276.  
  277. Change Fast v1.02d is Copyright (C) D.Manders 1995-1996, All rights reserved.
  278.  
  279. D.Manders Software
  280. Dorpsstraat 46
  281. 5758 AS, Neerkant
  282. Holland
  283.  
  284. DMSoft is a shortening of D.Manders Software, and is NOT an official registered
  285. Company-name or something like that. If any software company wich uses DMSoft
  286. as it's name disagrees to the shortening of D.Manders Software to DMSoft than
  287. please let me know !
  288.  
  289. Anyone is free to use, copy, download and distribute CF as long as you agree to
  290. these next terms:
  291.  - No fee may be charged for copying or distributing CF in any way.
  292.  - This manual has to be distibuted along with CF !
  293.  - Both CF.EXE as CF.DOC may not be modified in any way (that includes renaming)
  294.  - The programmer is NOT responsible for any damage to your hard- or software
  295.    wich may be (but is unlikely to be) caused by CF.
  296.  - You are free to distribute CF on any media (CD-ROM, BBS, Internet, etc.)
  297.  
  298.  
  299. Any suggestions, questions, bug reports ? - please drop me an e-mail at:
  300.  
  301.   dms@via.nl
  302.  
  303. Please register (it's FREE !)
  304.  
  305. ────DM'96───────────────────────────────────────────────────────────────────────
  306.